home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / graphics / dcview21.zip / CVIEW.TXT < prev    next >
Text File  |  1993-01-07  |  41KB  |  1,093 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.             ColorView(tm)  for DOS
  9.                  Version 2.1
  10.  
  11.               Copyright (C) 1992
  12.         by Millennium Technologies Corporation
  13.              ALL RIGHTS RESERVED
  14.  
  15.  
  16.  
  17.  
  18.         Millennium Technologies Corporation(tm)
  19.              Suite #205, 649 61st Street
  20.            West New York, New Jersey 07093
  21.  
  22.                             DOS ColorView 2.1
  23.  
  24.  
  25.             TABLE OF CONTENTS        Page
  26.  
  27. Shareware                        1
  28. ASP Ombudsman Statement                 1
  29. Disclaimer - Agreement                    2
  30. Registration                        3
  31. Registration Form                    4
  32. Introduction                        5
  33. Hardware & Software Requirements            5
  34. ColorView Features                    6
  35. Some Commonly Asked Questions                6    
  36. Setting Up                        7
  37. User's Guide                        8
  38.   Command Line Arguments                8
  39.     Batch Image Conversions                9
  40.   Standard VGA Video Mode                10
  41.   User Interaction (VESA SuperVGA Video Modes)        11
  42.     Menu Selection                    11
  43.     Mouse Functionality                    11
  44.     Keyboard Functionality                12
  45.   Menu Commands                        14
  46.     File Menu                        14
  47.     Options Menu                    16
  48.     Edit Menu                        17
  49.     Clip Menu                        20
  50. Appendix A                        23
  51.  
  52.                 -1-            DOS ColorView 2.1
  53.  
  54.  
  55. ColorView for DOS is distributed as SHAREWARE. Please read the following
  56. information before using it:
  57.  
  58.  
  59.  
  60.  
  61.                 SHAREWARE
  62.  
  63.  
  64.     ColorView is a shareware product, it is not free. Shareware
  65. distribution gives users a chance to try software before buying it. If
  66. you try a Shareware program and continue using it, you are expected to
  67. register. With your registration of ColorView for DOS Version 2.1, you
  68. will receive a diskette with the latest version of the software and
  69. documentation.
  70.  
  71.  
  72.     Copyright laws apply to both Shareware and commercial software,
  73. and Millennium Technologies Corporation retains all rights, with a few
  74. specific exceptions as stated below.  You are specifically granted the
  75. right to copy and distribute the ColorView for DOS package, complete
  76. and unmodified, as described in the Disclaimer-Agreement  section below.
  77.  
  78.     Shareware is a distribution method, not a type of software. The
  79. Shareware system makes fitting your needs easier, because you can try it
  80. before you buy it. And because the overhead is low, prices are low.
  81. Shareware has the ultimate money-back guarantee -- if you don't use the
  82. product, you don't pay for it.
  83.  
  84.  
  85.  
  86.             ASP OMBUDSMAN STATEMENT
  87.  
  88. Millennium Technologies Corporation is a member of the Association of
  89. Shareware Professionals (ASP).  ASP wants to make sure that the shareware
  90. principle works for you.  If you are unable to resolve a shareware-related
  91. problem with an ASP member by contacting the member directly, ASP may be
  92. able to help.  The ASP Ombudsman can help you resolve a dispute or problem
  93. with an ASP member, but does not provide technical support for members'
  94. products.  Please write to the ASP Ombudsman at 545 Grover Road, Muskegon,
  95. MI 49442 or send a CompuServe message via CompuServe Mail to ASP Ombudsman
  96. 70007,3536.
  97.                 -2-            DOS ColorView 2.1
  98.  
  99.             DISCLAIMER - AGREEMENT
  100.  
  101. Users of ColorView must accept this disclaimer of warranty:
  102.  
  103. "ColorView is supplied as is. Millennium Technologies Corporation disclaims
  104. all warranties, expressed or implied, including, without limitation, the
  105. warranties of merchantability and of fitness for any purpose. Millennium
  106. Technologies Corporation assumes no liability for damages, direct or
  107. consequential, which may result from the use of ColorView."
  108.  
  109. ColorView is a "shareware program" and is provided at no charge to the user
  110. for evaluation.  Feel free to share it with your friends, but please do not
  111. give it away altered or as part of another system.  The essence of
  112. "user-supported" software is to provide personal computer users with quality
  113. software without high prices, and yet to provide incentive for programmers
  114. to continue to develop new products.  If you find this program useful and
  115. find that you are using ColorView and continue to use ColorView after a
  116. reasonable trial period, you must make a registration payment of $29.95
  117. to Millennium Technologies Corporation (please use the registration form
  118. below). The $29.95 registration fee will license one copy for use on any
  119. one computer at any one time.  You must treat this software just like a
  120. book.  An example is that this software may be used by any number of people
  121. and may be freely moved from one computer location to another, so long as
  122. there is no possibility of it being used at one location while it's being
  123. used at another. It is just like a book which cannot be read by two
  124. different people at the same time.
  125.  
  126. Commercial users of ColorView must register and pay for their copies of
  127. ColorView within 30 days of first use or their license is withdrawn.
  128. Site-License arrangements may be made by contacting Millennium
  129. Technologies Corporation.
  130.  
  131. Anyone distributing ColorView for any kind of remuneration must first
  132. contact Millennium Technologies Corporation at the address below for
  133. authorization. Millennium Technologies Corporation should be advised
  134. so that the distributor can be kept up-to-date with the latest version
  135. of ColorView for DOS.
  136.  
  137. Disk Vendors, Shareware Distributors and BBS(s) may charge a nominal fee
  138. for distribution of the program. The recipient of ColorView must be
  139. informed, in advance, that the fee paid to acquire ColorView does not
  140. relieve the recipient from paying the Registration Fee for ColorView
  141. if the recipient uses ColorView.
  142.  
  143. You are encouraged to pass a copy of ColorView along to your friends for
  144. evaluation.  Please encourage them to register their copy if they find
  145. that they can use it.  All registered users will receive a copy of the
  146. latest version of the ColorView system.
  147.  
  148.                 -3-            DOS ColorView 2.1
  149.  
  150.                 REGISTRATION
  151.  
  152.     The ColorView for DOS registration fee is $29.95 plus Shipping
  153. and Handling. With your registration for ColorView for DOS Version 2.1,
  154. you will receive the latest copy of the software and the documentation,
  155. and will be notified of all later releases of ColorView for DOS.
  156. Subsequent versions of ColorView for DOS will be made available to
  157. registered users for a nominal fee to cover costs.
  158.  
  159.     As ColorView is ported to other Operating Environments and CPU
  160. platforms, registered users will be given a direct registration price
  161. of $10 for each additional version of ColorView for the new platforms
  162. and new environments. Discounts for other software product lines from
  163. Millennium Technologies and other products will also be made available
  164. to registered users of ColorView for DOS.
  165.  
  166. You can register ColorView by:
  167.  
  168.  
  169.  *  CHECK or MONEY ORDER in US funds drawn on a US bank by mailing the
  170. check/money order along with the order form on the next page directly
  171. to Millennium Technologies Corporation;
  172.  
  173. if you wish to mail an order directly to Millennium Technologies from
  174. outside the US, please try to use POSTAL MONEY ORDERS (which are usually
  175. free of conversion charges) from your national postal offices, or try to
  176. use American Express money orders or traveler's checks;
  177.  
  178.  
  179.  *  CREDIT CARD from PsL (Public (software) Library) with your Master Card,
  180. Visa, American Express, or Discover card by :
  181.  
  182.     calling 800-242-4PsL in the United States;
  183.     calling 713-524-6394 from outside the United States;
  184.     faxing your order form to  713-524-6398;
  185.     or e-mailing your order through CompuServe to  71355,470.
  186.  
  187. When ordering from PsL, please refer to product number 10677.
  188.  
  189. The PsL numbers are for ordering only.    Millennium Technologies Corporation
  190. cannot be reached at those numbers.  To contact us for information about
  191. dealer pricing, volume discounts, site licensing, the status of shipment
  192. of the product, the latest version number, technical information or
  193. problems, or to discuss returns, please contact Millennium Technologies
  194. Corporation directly at:
  195.  
  196.         Millennium Technologies Corporation
  197.         Suite #205, 649 61st Street
  198.         West New York, New Jersey 07093
  199.  
  200. or through CompuServe at 71055,2625.
  201.                 -4-            DOS ColorView 2.1
  202.  
  203. Please use this form to register ColorView by mail or fax:
  204.  
  205.              REGISTRATION FORM
  206.  
  207.              ColorView    for DOS  v. 2.1
  208.  
  209. NAME:  ______________________________________________
  210.  
  211. STREET:______________________________________________
  212.  
  213. CITY:  ______________________________________________
  214.  
  215. STATE: ___________________________ZIP________________
  216.  
  217. TELEPHONE: _________________________
  218.  
  219.  
  220. ColorView License Number...............    $29.95    ______
  221.  
  222. New Jersey Residents add 6% sales tax..    ($1.80)    ______
  223.  
  224. US Residents - Shipping and Handling...     $5.00    ______
  225.  
  226. Other - Shipping and Handling .........     $8.00    ______
  227.                            
  228.  
  229. Total in US Funds drawn on a US Bank..    $________________
  230.  
  231.  
  232.     Circle Disk Size:    3 1/2"      5 1/4"
  233.  
  234.  
  235. Make checks payable to: Millennium Technologies Corporation
  236.  
  237. Mail to:    Millennium Technologies Corporation
  238.         Suite #205, 649 61st Street
  239.         West New York, New Jersey 07093
  240.  
  241. CREDIT CARD INFORMATION: Please do not mail your Credit Card orders.
  242. Please FAX them directly to PsL at 713-524-6398, or phone them in to PsL,
  243. or CompuServe E-Mail your orders to PsL as described on the previous page. 
  244.  
  245. I am paying by: MC ____  Visa ____  American Express ____  Discover ____
  246.  
  247. Name as it appears on the card:    _______________________________________
  248.  
  249. Credit card number:        _______________________________________
  250.  
  251. Card expiration date:        _______________________________________
  252.  
  253. Signature:          _________________________________________________
  254.  
  255.                 -5-            DOS ColorView 2.1
  256.  
  257.                 INTRODUCTION
  258.  
  259.     ColorView is a program designed to view and manipulate color images
  260. in the DOS environment.
  261.  
  262.  
  263. HARDWARE & SOFTWARE REQUIREMENTS
  264.  
  265. The following hardware and software is supported by this version of
  266. ColorView for DOS:
  267.  
  268.  Any non-graphics display:
  269.     Can only be used for batch image conversions.
  270.  
  271.  Standard VGA display (320x200 pixels):
  272.     8-bit, 256 color, palette based, or
  273.  
  274.  VESA SuperVGA display (640x400 pixels and above):
  275.     8-bit, 256 color, palette based,  or
  276.     15-bit 'true' (32768 colors) color, or
  277.     16-bit 'true' (65356 colors) color, or 
  278.     24-bit true color.
  279.  
  280.     The display must be VESA 1.2 compatible or you must have a VESA
  281.     software driver installed.
  282.  
  283. CPU:    80286 or above.
  284.  
  285. Memory: As much as possible. Anything from 640 kilobytes to infinity is
  286.     recommended. In general, the more memory you have available (either
  287.     expanded or extended), the bigger the image you can display (and 
  288.     the faster ColorView will run). ColorView will automatically utilize
  289.     your hard disk as temporary storage if there is not enough physical
  290.     memory. It is also important to have approximately 500K of free
  291.     DOS memory before starting ColorView. 
  292.  
  293. Operating System:
  294.     DOS 2.x, 3.x, 4.x, 5.x
  295.  
  296. Hard Disk Space:
  297.     In general, you will need at least 4 times the image size of
  298.     temporary space on your hard disk if there is not enough physical
  299.     memory. For example, an 800 x 600 24-bit image will require 
  300.     approximately 1.8 Mbytes.
  301.  
  302. Optional Mouse:
  303.     ColorView will use a Microsoft compatible mouse if one is 
  304.     available. Make sure that the mouse driver is installed
  305.     before starting ColorView for DOS.
  306.  
  307.                 -6-            DOS ColorView 2.1
  308.  
  309. COLORVIEW FEATURES
  310.  
  311. This version of the software supports the following image formats:
  312.  
  313.     Reading and Writing:
  314.  
  315. JPEG (JFIF subset) *.JPG:        24-bit color, highly compressed images
  316. GIF'87, GIF'89(reading)    *.GIF:        LZW encoded 8-bit palette based images
  317. Windows Bitmaps    *.BMP (also RLE-8):    4-bit, 8-bit and 24-bit color images
  318.  
  319.  
  320. Some Commonly Asked Questions:
  321.  
  322. Q: Will CVIEW.EXE run on 80386 SX processor?
  323. A: Yes
  324.  
  325. Q: Is there a Windows version of ColorView?
  326. A: There is a preliminary version of ColorView for Windows available.
  327.  
  328. Q: Does ColorView create temporary files?
  329. A: Yes. Their creation and size will depend on the image you are trying
  330. to load and the amount of physical RAM you have in your computer.
  331.  
  332. Q: Why doesn't ColorView work with my graphics card?
  333. A: ColorView supports graphics cards through the VESA SuperVGA protocol
  334.    standard. Virtually all of the graphics card manufacturers are members
  335.    of the VESA group and provide free software drivers for their graphics
  336.    cards. Make sure your graphics card supports the VESA standard, or 
  337.    obtain a software driver that provides VESA functionality for your card.
  338.  
  339. Q: Can I use ColorView with my standard VGA card?
  340. A: Yes. ColorView now supports the standard VGA 320x200 video mode. Read
  341.    the Standard VGA Video Mode section for more details.
  342.  
  343. Q: Why doesn't ColorView support the 24-bit mode on my graphics card?
  344. A: ColorView supports all of the Vesa modes which are available
  345.    through your VESA driver. Although there are many graphics cards
  346.    supporting the 24-bit mode, the graphics card companies have been
  347.    slow to update their software drivers.
  348.  
  349. Q: ColorView suddenly stopped working on my computer. What should I do?
  350. A: ColorView provides an option for saving your personal configuration
  351.    information into CVIEW.CFG file. If this file has been damaged, 
  352.    ColorView might not initialize correctly. To solve this problem,
  353.    simply delete this file.
  354.  
  355.                 -7-            DOS ColorView 2.1
  356.  
  357.                 SETTING UP
  358.  
  359.        ColorView uses Overlay technology to reduce its demands on lower
  360. DOS memory.  For ColorView to function properly, you must either run
  361. ColorView in the directory where CVIEW.EXE resides or have that
  362. directory included on your path.  
  363.  
  364.        24-bit color images are notorious for taking up large amounts of
  365. memory.  For example, when decoded for display, a 640 x 480 24-bit JPEG
  366. file will take up almost 1Mbyte of memory.  The discussion that follows
  367. will provide some hints on how to best configure your computer to take
  368. advantage of the available physical RAM.  
  369.  
  370.        ColorView is intended for palette-based or true-color displays.
  371. Through the VESA standard, ColorView will query the display driver to get
  372. the type and the resolution of your graphics card.  If your driver is not
  373. properly installed, or if your graphics card does not support some of the
  374. features necessary for ColorView, ColorView will display a message alerting
  375. you to the situation.  
  376.  
  377.        When using 24-bit or 15-bit true-color graphics cards, ColorView
  378. will require less memory for image conversion and the conversion will run
  379. faster.  This is due to the elimination of two steps: 8-bit color reduction
  380. (quantizing) and dithering.  If you choose an option that requires a 24 to
  381. 8-bit conversion (such as saving a GIF or an 8-bit BMP file), ColorView
  382. will take a bit more time for the quantizing and dithering steps.
  383.  
  384. NOTE: If you are using an 8-bit Graphics Mode and you load a 24 bit JPEG
  385. or BMP picture, ColorView will create an 8-bit image for your graphics
  386. card. However, all image operations, especially saving files, will be
  387. done with the 24 bit image. There is one exception to this rule: in the
  388. interests of performance, the Enhance Color option will operate on the
  389. 8-bit version of the image. Please see the section describing the Edit
  390. Menu and the Enhance Color option for more details. This note is not
  391. important if you are using a 24-bit Graphics Mode. We just want to
  392. reassure you that ColorView will automatically maintain and use the
  393. highest quality version of your pictures.
  394.                 -8-            DOS ColorView 2.1
  395.  
  396.                 USER'S GUIDE
  397.  
  398. COMMAND LINE ARGUMENTS
  399.  
  400. ColorView can be used as an image viewer/editor or as a batch image
  401. conversion utility. For description of the latter, please see the
  402. 'Batch Image Conversions' section below.
  403.  
  404. ColorView can be started alone, or with command-line arguments  as
  405. follows:
  406.  
  407.     CVIEW  [-M mode] [-V][-D][-F][-S][-?] [@file] [file [file] ...]
  408.  
  409.     -M  use the specified (decimal) VESA video mode
  410.         NOTE: the VESA mode numbers are obtained by
  411.         querying your graphics card. There is no table
  412.         which you can look up to get standardized video
  413.         mode codes.
  414.  
  415.     -V  use the standard VGA 320x200x8 video mode
  416.         NOTE: this mode does not require a VESA driver.
  417.         Please read the note below which discusses some
  418.         of the limitations of this mode.
  419.  
  420.     -D  turn dithering on for 24-bit images in 8-bit (LUT)
  421.         display modes
  422.  
  423.     -F  stretch the images to fit the screen
  424.         while preserving the aspect ratio
  425.  
  426.     -S  continuously cycle between selected images
  427.         (Slideshow mode)
  428.  
  429.     -?  display a summary of the command-line options
  430.  
  431. Additional Notes:
  432.  
  433.     More than one file name can be specified on the command line.
  434.  
  435.     Wild card characters: * and ? can be used to select multiple files.
  436.  
  437.     A script file can be selected by preceding its name with '@'.
  438.  
  439.     A script file can contain a list of images to be displayed
  440.     (one file per line).
  441.  
  442. For example:
  443.  
  444.     CVIEW  -M 261 -D -F  C:\CVIEW\PALACE.JPG C:\CVIEW\FLOWER.JPG
  445.  
  446.     will load two files, PALACE.JPG and FLOWER.JPG in sequence.
  447.     The graphics mode will be set to '261', dithering will be
  448.     enabled, and the Fit-To-Screen option will be used.
  449.  
  450.     (HINT: use ColorView's Graphics Mode menu to find out which
  451.     graphics modes are available with your graphics card).  
  452.                 -9-            DOS ColorView 2.1
  453. Batch Image Conversions
  454.  
  455. ColorView can be used to convert multiple files from one graphics format
  456. to another. This function operates completely in the TEXT display mode,
  457. and therefore DOES NOT REQUIRE EITHER A GRAPHICS CARD OR A VESA INTERFACE.
  458.  
  459. Use this feature when you want to convert a set of images to any one of
  460. the supported image file formats. In addition to converting the supported
  461. file formats, ColorView allows arbitrary scaling to be performed on the
  462. processed images. One the batch process is started, the resulting files
  463. are created with an appropriate file name extension and written into the
  464. current directory.
  465.  
  466. These command line options may be used during batch conversions:
  467.  
  468.     CVIEW  [-G] [-B8][-B24][-BRLE] [-Jq] [-Xw] [-Yh] [-O] [@file] file...
  469.  
  470.     -G    convert the source images into GIF'87 format
  471.     -B8    convert into the Windows 8 bit BMP format
  472.     -B24    convert into the Windows 24 bit BMP format
  473.     -BRLE   convert into the Windows 8 bit RLE format
  474.     -Jq    convert into the JPEG/JFIF format, using a quality
  475.         factor of 'q'.
  476.         'q' can be a number from 1 to 100, with 100 being the
  477.         highest quality setting.
  478.     -Xw    scale the output image to fit into 'w' pixels horizontally
  479.     -Yh    scale the output image to fit into 'h' pixels vertically
  480.         (NOTE: scaling will always preserve the correct aspect ratio)
  481.     -O    overwrite existing files even if a name conflict occurs. If
  482.         this option is not used, ColorView will ask you what to do
  483.         whenever a file is in danger of being overwritten.
  484.  
  485. More than one file can be specified on the command line. A list of files
  486. can be converted by entering the list of file names into a script file.
  487.  
  488. Examples:
  489.  
  490.     CVIEW  -J80 \images\gif\*.gif \images\bmp\*.bmp
  491.  
  492.     will convert all of the specified GIF and BMP images into the
  493.     JPEG/JFIF file format with a quality setting of 80.
  494.  
  495.     CVIEW    -G @allpics.scr -X640 -Y480 -O
  496.  
  497.     will convert all of the image files listed in the script file
  498.     'allpics.scr' into the GIF file format. The GIF files will be scaled
  499.     to fit into 640 x 480 pixels. Any pre-existing GIF files with the
  500.     same name as a converted file will be overwritten without prompting.
  501.                 -10-            DOS ColorView 2.1
  502.  
  503.             Standard VGA Video Mode
  504.  
  505.     In order to support the older video boards which do not have a
  506. VESA interface, and to support the standard VGA video boards (non-SuperVGA),
  507. ColorView now allows viewing images in the standard VGA 320x200 by 8-bit
  508. video mode.
  509.  
  510. NOTE:     Due to the extremely poor resolution, the menus and all of their
  511. associated functionality will not be available in this mode. All of the
  512. display options and the list of files must be specified on the command
  513. line when starting ColorView for DOS in this mode.  
  514.  
  515.        For example: 
  516.  
  517.         CVIEW -V -D -F \jpegs\*.jpg \gifs\*.gif 
  518.  
  519.     The results of entering this command line are to view all of the
  520. JPEG/JFIF and GIF files in the respective directories, using dithering,
  521. and Fitting (scaling) the pictures to the 320x200 video screen.
  522.  
  523.     The <Enter> key will advance you to the next image in the file list.
  524.  
  525.     The <Esc> key will stop the current image decompression operation.
  526.  
  527.     The <=> key will toggle the "Fit-To-Screen" option on and off.
  528.         This will allow you to see the whole image, or to
  529.         see the portion of the image that fits into the
  530.         320x200 display.
  531.  
  532.     The arrow keys will allow you to scroll the image.
  533.  
  534.     To exit ColorView from this mode, press <Ctrl>-C.  
  535.  
  536.                 -11-            DOS ColorView 2.1
  537.  
  538.               USER INTERACTION
  539.  
  540.            (in VESA SuperVGA Video Modes)
  541.  
  542. Menu Selection
  543. ==============
  544.  
  545.     ColorView uses a unique way of representing pop-up menus: Pizza Menus.
  546.     A Pizza-Menu is a list of choices organized as slices of a pizza.  A
  547.     slice can be selected by moving a mouse over any area belonging to it,
  548.     and clicking the left mouse button. A slice can also be selected by
  549.     simply typing in the underlined letter in the menu slice.
  550.  
  551. Mouse vs. Keyboard
  552. ==================
  553.  
  554.     Most of the operations in ColorView can be accomplished with a mouse
  555.     or through the keyboard. The Mouse control features will automatically
  556.     be enabled if an appropriate Microsoft compatible mouse driver is
  557.     detected. The keyboard controls can be used regardless of whether a
  558.     mouse is present.
  559.  
  560. Mouse Functionality
  561. ===================
  562.  
  563. The mouse cursor can only be used when the ColorView menu-bar is visible:
  564.  
  565. -  To display the menu bar, click on the right mouse buttons;
  566.  
  567. -  To close the menu bar, click the right mouse button;
  568.  
  569. -  To select an item from a menu:
  570.    Move the mouse cursor over the menu item you wish to select,
  571.    and then click the left mouse button;
  572.  
  573. -  To scroll an image while the menu-bar is visible:
  574.    Move the mouse cursor in the direction you would like to scroll
  575.    and hold down the left button.
  576.  
  577. -  To choose a file from the file-selection list:
  578.    Move the mouse cursor on top of the file name, and click the
  579.    left button. Clicking again will de-select the file.
  580.  
  581. -  To choose an option or a graphics mode from a list of choices:
  582.    Move the mouse cursor on top of the desired option, and
  583.    click the left mouse button.
  584.  
  585. -  To select an area of an image, move the mouse cursor to the
  586.    top left corner of the area, press the left mouse button,
  587.    and then drag the mouse pointer to the bottom right corner
  588.    of the area.
  589.        
  590.                 -12-            DOS ColorView 2.1
  591.  
  592. Keyboard Functionality
  593. ======================
  594.  
  595. -  To display the menu bar, press the <Esc> key once;
  596.  
  597. -  To close the menu bar, press the <Esc> key once;
  598.  
  599. -  To select an item from a menu:
  600.  
  601.    Each top level menu item has an underlined letter - that letter
  602.    is a keyboard short-cut key (e.g. 'F' activates the File menu and
  603.    'O' activates the Options menu).
  604.  
  605.    After the desired top level menu item is selected, press the
  606.    short-cut key for the desired menu item (e.g. 'O' for Open in the
  607.    File menu).
  608.  
  609.    Thus, an 'FO' sequence of keystrokes will bring up the file
  610.    selection screen;
  611.  
  612. -  To abort an operation or to cancel a current screen or
  613.    selection, press the <Esc> key. 
  614.  
  615. -  To confirm a selection from any screen, press the <Enter> key.
  616.  
  617. -  To quit ColorView from any point, press <Ctrl>-C or 
  618.    <Ctrl>-<Break>.
  619.  
  620. -  To advance to the next image:
  621.  
  622.    If you have selected more than one image, you can advance to
  623.    the next one by pressing the <Enter> key. To go back to the
  624.    previous image, press <Backspace>. Note: when the last image
  625.    is displayed, the next image will be the first one selected.
  626.  
  627. -  To choose a file from the file-selection list:
  628.  
  629.    Use the arrow keys to move the selection rectangle to the
  630.    desired file name. Press the Space Bar once to select the file,
  631.    one more time to un-select it.
  632.  
  633.    (HINT: if you hold down the <Shift> key while using arrow
  634.     keys to highlight different file names, each file name 
  635.     you pass over will be automatically toggled.)
  636.  
  637. -   To scroll a displayed image, use the arrow keys, and the
  638.     <PgUp>, <PgDn>, <Home>, and <End> keys.
  639.  
  640.                 -13-            DOS ColorView 2.1
  641.  
  642. -   To resize a displayed image to Fit on the screen, use the
  643.     <=> key. Press the <=> key again to return to the original
  644.     display size.
  645.  
  646. -   To select an area of an image, choose the 'Select Area' menu
  647.     item from the 'Clip' menu. You will see an area selection
  648.     rectangle at the top left part of your screen. Use the arrow
  649.     keys to position the area selection rectangle at the top left
  650.     corner of the area.
  651.  
  652.     Hold down the <Shift> key and use the arrow keys to enlarge or 
  653.     to reduce the area selection rectangle. 
  654.  
  655.                 -14-            DOS ColorView 2.1
  656.  
  657.                MENU COMMANDS
  658.  
  659.     ColorView distinguishes between screen images, which is what you see on
  660.     your display monitor, and memory images, which is what is internally
  661.     stored by ColorView and can be written to a file.  Please note which
  662.     version of the image is affected by each of the menu commands described
  663.     below.  
  664.  
  665.  
  666. File Menu    - Options related to reading and writing images and
  667.         other system functions.
  668.  
  669.     File    New Image
  670.     -----------------
  671.     Removes the loaded image from memory and clears the display window.
  672.  
  673.     File    Open...
  674.     ---------------
  675.     Displays a dialog box which will allow you to select an image file
  676.     to load.
  677.  
  678.     Version 2.1 recognizes the image format of the file by its file
  679.     name extension (.JPG, .GIF, .BMP).
  680.  
  681.     File    Save As...
  682.     ------------------
  683.     Allows you to save an image in a different graphics file format.
  684.     An image must be loaded into memory before this option can be used.
  685.  
  686.     NOTE: The file name extension determines the image format which is
  687.     saved. The following extensions are recognized:
  688.  
  689.         .JPG    for JPEG/JFIF files
  690.         .GIF    for GIF files
  691.         .BMP    for 8, RLE-8, and 24-bit Windows Bitmaps
  692.  
  693.     For example: image.bmp, image.gif, image.jpg.
  694.  
  695.     When saving JPEG/JFIF files, you will be prompted for a quality
  696.     setting. 100 is the highest quality setting, and 2 is the lowest
  697.     quality setting. A low quality setting will produce a smaller
  698.     JPEG/JFIF file, but the image clarity will be greatly reduced.
  699.  
  700.     When saving BMP files, you will be prompted to select the type
  701.     of file you want to write. The option selections are:
  702.  
  703.         Compressed 8-bit RLE
  704.         8-Bit Uncompressed
  705.         24-Bit Uncompressed
  706.  
  707.     (Note that not all Microsoft Windows utilities support the
  708.     8-bit RLE graphics file format.)
  709.  
  710.                 -15-            DOS ColorView 2.1
  711.  
  712.     File    Save Options
  713.     --------------------
  714.     Provides a way to save the configuration options (from the Options
  715.     pop-up menu) to be used in future ColorView sessions. The next time
  716.     ColorView is started, it will automatically be configured to the
  717.     state ColorView was in when the options were saved.
  718.  
  719.     NOTE: A CVIEW.CFG file will be created in the directory that
  720.     the running version of ColorView for DOS was started from.
  721.  
  722.     File    About ColorView
  723.     -----------------------
  724.     Displays the ColorView for DOS Copyright and Registration messages.
  725.  
  726.     File    Exit ColorView
  727.     ----------------------
  728.     Exits ColorView, releasing all of the allocated resources and memory.
  729.  
  730.                 -16-            DOS ColorView 2.1
  731.  
  732. Options    Menu    - Display and image characteristics.
  733.  
  734.     Options    Graphics Mode...
  735.     ------------------------
  736.     All of the available VESA graphics modes which are greater than
  737.     640x400 and have at least 256 colors will be listed. This includes
  738.     the 15/16-bit HiColor display modes, and 24-bit TrueColor display
  739.     modes. When a mode is selected, ColorView will shift to the
  740.     selected graphics mode.
  741.  
  742.     You can use the File Menu "Save Options" command to configure
  743.     ColorView to start up in the current resolution and number of
  744.     colors.
  745.  
  746.     If your graphics card supports more modes than are listed, please
  747.     try to locate a more current VESA driver for your graphics card.
  748.  
  749.     You can switch to another graphics mode after an image has been
  750.     loaded, even if the mode you are selecting supports a different
  751.     number of colors from the display mode you are currently using.
  752.  
  753.     Options    Dither Image
  754.     --------------------
  755.     When performing a 24-bit to 8-bit conversion, this option tells
  756.     ColorView to use dithering to smooth out quantization
  757.     (Heckbert color reduction processing) errors.
  758.  
  759.     In most cases, dithering will significantly improve the color
  760.     reproduction for displays that support less than 15-bits of color.
  761.     In some cases, the memory image might become a little less sharp.
  762.  
  763.     ColorView uses Floyd-Steinberg dithering.
  764.  
  765.     Dithering has no effect on 15, 16 or 24-bit color display modes.
  766.  
  767.     Options    Fit To Screen
  768.     ---------------------
  769.     Resizes the screen image to fit into your display screen.
  770.     Only the display is changed. The memory image remains at the
  771.     original size.
  772.  
  773.     Options    Slide Show
  774.     ------------------
  775.     Tells ColorView not to pause between multiple images and also
  776.     turns off the image preview and the progress indicator. In this
  777.     mode, an image is not shown until it is completely processed and
  778.     ready to be displayed. This creates a smooth transition between
  779.     consecutive images and eliminates the need for mouse or keyboard
  780.     interaction.
  781.  
  782.     Please note that the slide show mode will continue to cycle
  783.     through all of the selected images until the <Esc> key is
  784.     used to stop the display and return you to the menu.
  785.  
  786.                 -17-            DOS ColorView 2.1
  787.  
  788. Edit Menu    - Image manipulation functions.
  789.  
  790.     NOTE:  Most of the options under the Edit menu are applied to the
  791.     24-bit representation of the image. The only exception to this is
  792.     the "Enhance Color" option which works on the 8 or 24-bit memory
  793.     image depending on your current display mode characteristics.
  794.     (In other words, if you are using an 8-bit display, the
  795.     "Enhance Color" option will operate on the 8-bit memory image.
  796.     If you are using a 15-bit, 16-bit, or 24-bit display, then
  797.     the "Enhance Color" option will operate on the 24-bit memory image.)
  798.  
  799.     Generally, if the image you have loaded is an 8-bit image,
  800.     ColorView will automatically convert it to a full 24-bit image,
  801.     perform the requested operation and then convert the result back
  802.     into an 8-bit image. Because of this, we recommend that you enable
  803.     the "Dither" option in the Options menu when manipulating 8-bit
  804.     images (or using an 8-bit display mode) for Edit operations.
  805.  
  806.     Edit    Scale Image...
  807.     ----------------------
  808.     Resizes the memory image to the specified size.  This operation
  809.     can be performed with and without preserving the aspect ratio
  810.     of the original image.    The ColorView scaling algorithm is
  811.     specially designed to maintain the highest possible quality of the
  812.     image.    For instance, unlike most scaling algorithms, text in the
  813.     image will generally be preserved when scaling down.  This feature
  814.     allows you to permanently reduce or enlarge your image for saving
  815.     or pasting.
  816.  
  817.     NOTE: this function is performed on the 24-bit memory image.  
  818.  
  819.     Edit    Filter Image
  820.     --------------------
  821.  
  822.     Convolution filtering of the 24-bit memory image.  All of the
  823.     filters can be applied multiple times for a stronger effect.  
  824.  
  825.     The currently supported filters are:
  826.  
  827.         0: Sharpen a Little
  828.             Improves edge contrast for blurry or washed-out
  829.             images. This can be used to improve image sharpness
  830.             after an image has been scaled. This filter can also
  831.             improve image quality for images scanned at low 
  832.             resolutions.
  833.  
  834.         1: Sharpen a Lot
  835.             Significantly increases image sharpness.
  836.  
  837.                 -18-            DOS ColorView 2.1
  838.  
  839.         2: Soften a Little
  840.             Softens the image by reducing the color distance
  841.             between neighboring pixels. This can be used to
  842.             create 'blurry' or slightly out of focus effects.
  843.             This can also be used to improve the visual
  844.             quality of grainy images.
  845.  
  846.         3: Soften a Lot
  847.             Same as Soften a Little, except the effect is more
  848.             pronounced.
  849.     
  850.         4: Emboss
  851.             This filter produces a "raised relief" out of an
  852.             existing image. 
  853.  
  854.         5: Maximum Filter
  855.             Assigns each pixel the maximum color value of its
  856.             immediate neighbors. This filter can be used to
  857.             produce a mosaic type of an effect.
  858.  
  859.             The filter produces larger mosaic pieces each time
  860.             that it is applied. If the image becomes blurry you
  861.             can use the "Sharpen a Lot" filter for a more
  862.             pronounced effect.
  863.  
  864.         6: Minimum Filter
  865.             Same as the Maximum filter, except each pixel is
  866.             assigned the minimum color value of its immediate
  867.             neighbors.
  868.  
  869.         7: Find Edges
  870.             Produces a thin-line or dot drawing of the edges
  871.             in an image, removing all other color information.
  872.  
  873.     Edit    Enhance Color - 8, 15 and 24-bit displays
  874.     ---------------------
  875.     Provides a way to color correct a memory image. Note that on 8-bit
  876.     (256) color displays, corrections are fast because only the palette
  877.     will be updated. On 15/16 and 24-bit displays, any change must
  878.     modify every single pixel in the image, resulting in a much slower
  879.     response time.
  880.  
  881.     The Color Enhancement panel contains 4 scale factors which are
  882.     described below. We suggest that you experiment with an 8-bit (256)
  883.     color version of your image to determine the approximate adjustment
  884.     values and then convert the 24-bit version of your image.
  885.     (In other words, use an 8-bit Graphics Mode to preview the
  886.     "Enhance Color" values, and then switch to a 15-bit, 16-bit, or
  887.     24-bit Graphics Mode to color correct the memory image.)
  888.  
  889.                 -19-            DOS ColorView 2.1
  890.  
  891.     NOTE:    Closing the Color Enhancement panel will not restore the
  892.     original colors. To restore the original colors, uncheck the
  893.     "Enhance Color" menu option in the Options menu.
  894.  
  895.             Hue: 
  896.         range 0 to 360, normal at 180: changes the hue of the image.
  897.  
  898.             Sat:
  899.         range 0 to 255, normal at 128:    changes the amount of
  900.         color in the image. A saturation of 0 means no color
  901.         (a black & white image).
  902.  
  903.             Vol:
  904.         range 0 to 255, normal at 128: adjusts overall image
  905.         brightness.
  906.  
  907.             Gamma Factor: 
  908.         range 0 to 1000, normal at 0: gamma-corrects the image.
  909.  
  910.         This option provides a way to correct for the difference
  911.         between perceived colors and their computer generated
  912.         equivalents. This can be very useful in adjusting scanned
  913.         images, improving the sharpness and contrast of the raw
  914.         scan. If the original has already been gamma-corrected,
  915.         additional corrections might degrade the image quality.
  916.  
  917.         (In effect, gamma correction linearizes the non-linear
  918.         color values which are obtained by the photo-receptors
  919.         in most color scanners.)
  920.  
  921.     Edit    Blank Image
  922.     -------------------
  923.     Creates a blank 24-bit memory image which can be used to assemble
  924.     pasted images. Both the size of the image and the background color
  925.     can be specified by entering the appropriate values into the Width,
  926.     Height, Red, Green and Blue input fields.
  927.  
  928.     Edit    Flip Vertical
  929.     ---------------------
  930.     Flips the 24-bit memory image vertically.
  931.  
  932.     Edit    Flip Horizontal
  933.     -----------------------
  934.     Flips the 24-bit memory image horizontally into its mirror image.
  935.  
  936.     Edit    Rotate 90 Degrees
  937.     -------------------------
  938.     Rotates the memory image by 90 degrees clockwise.
  939.     Please note that this operation may take some time because
  940.     two 24-bit memory images are constructed, and this may require
  941.     creating and operating on temporary files on your hard disk.
  942.  
  943.                 -20-            DOS ColorView 2.1
  944.  
  945. Clip Menu    - Regional clipping and pasting functions
  946.  
  947.     If you have a properly configured Microsoft compatible mouse
  948.     installed, then you can simply select an area of the image using
  949.     the mouse. Just position the mouse cursor at the corner of the
  950.     area that you want to select, press and hold the left mouse button,
  951.     and then drag the cursor to the opposite corner and release the
  952.     mouse button. Please note that area selection operations for the
  953.     Clip functions require you to turn off the "Fit To Screen" option
  954.     in the "Options" menu.
  955.  
  956.     Clip    Select Area
  957.     -------------------
  958.     Activates the keyboard driven selection mode. The arrow keys
  959.     will move the selection window. Holding down the <Shift> key 
  960.     while using the arrow keys will move the bottom right corner
  961.     of the area selection window, effectively stretching or
  962.     contracting the selected area.
  963.  
  964.     (Hint: if you continue to hold down an arrow key or the
  965.     <Shift> key and an arrow key, the corner of the selection
  966.     window will travel faster. This will help you to navigate
  967.     around very large images.)
  968.  
  969.     This option should be used if you do not have a    properly
  970.     configured mouse installed, or if you want the extra precision
  971.     of keyboard control of the area selection window.
  972.  
  973.     Clip    Draw Text
  974.     -----------------
  975.     Assuming that an area has been selected in the image, this
  976.     command will paste your text into the upper left hand
  977.     corner of your selection window. The text color can be
  978.     specified by entering the appropriate Red, Green and Blue
  979.     values (0 to 255) in the dialog box.
  980.  
  981.     Clip    Paste From File
  982.     -----------------------
  983.     Provides for a powerful way of combining multiple images into
  984.     a single image. Before selecting this option, you must have an
  985.     image already loaded (or a blank new image created). The
  986.     original image and the image you are pasting can be of any
  987.     graphics file type supported by ColorView.
  988.  
  989.     The pasting operation is performed on the 24-bit memory image.
  990.  
  991.                 -21-            DOS ColorView 2.1
  992.  
  993.     Use the mouse or the "Select Area" option to mark the area of
  994.     the original image where you would like to place the pasted
  995.     image. After selecting "Paste From File", you can choose the
  996.     image file you would like to paste. You will then be asked to
  997.     enter the following parameters:
  998.  
  999.         Transparency            (in percent)
  1000.         Variable Transparency        (Yes/No)
  1001.         See thru Black            (Yes/No)
  1002.         Resize Image            (Yes/No)
  1003.         Stretch to Fit            (Yes/No)
  1004.  
  1005.     All of these options apply to the new image you are about to
  1006.     paste.
  1007.  
  1008.     Transparency (0 - 100): 
  1009.         Provides a way to control the transparency of the
  1010.         pasted image. The higher the value, the more transparent
  1011.         the pasted image will be.
  1012.  
  1013.         A 0% transparency will cause the pasted image to be
  1014.         completely solid.
  1015.  
  1016.         A 100% transparency will cause the pasted image
  1017.         to be completely transparent. (In other words, you
  1018.         can see through the pasted image.)
  1019.  
  1020.     Variable Transparency (Yes/No):
  1021.         Set this option to 'Yes' if you would like the pasted image
  1022.         to be more transparent at the edges and to be more solid in
  1023.         the center of the image. If this option is set to 'No' the 
  1024.         pasted image will have the same transparency factor over the
  1025.         entire area of the pasted image.
  1026.  
  1027.     See thru Black (Yes/No):
  1028.         This option provides the equivalent of a "Blue Screen"
  1029.         special effect used in movie production for combining
  1030.         certain individual parts of images to create composite
  1031.         effects.
  1032.  
  1033.         If you want to paste an irregularly shaped image, you can
  1034.         use your favorite bitmap editor to set all of the unwanted
  1035.         pixels to black. When pasted with the 'See thru Black' option
  1036.         set to 'Yes', all of the black pixels (RGB value of 0,0,0)
  1037.         will be    treated as 100% transparent, independent of any other 
  1038.         transparency settings.
  1039.  
  1040.         For example, you could use this function to fill a sky
  1041.         with a fleet of aircraft of different sizes and mirror
  1042.         orientations all based on a single aircraft image file.
  1043.  
  1044.                 -22-            DOS ColorView 2.1
  1045.  
  1046.     Resize Image (Yes/No):
  1047.         When set to 'Yes' this option tells ColorView to rescale
  1048.         the pasted image to fit into the selection window. When
  1049.         this option is set to 'No', the pasted image will be
  1050.         drawn in its original size, clipped to the size of the
  1051.         selection window.
  1052.  
  1053.     Stretch to Fit (Yes/No):
  1054.         This option should only be used in conjunction with the
  1055.         "Resize Image" option above. If this option is set to
  1056.         'Yes', ColorView will stretch the pasted image to exactly
  1057.         fit the selection window. In most cases, this will change
  1058.         the aspect ratio of the pasted image. Set this option to
  1059.         'No' if you would like to preserve the original aspect
  1060.         ratio.
  1061.  
  1062.     Clip    Copy To File
  1063.     --------------------
  1064.     This command is similar to the "Save" command in the "File"
  1065.     menu, except that this command operates on the portion of
  1066.     the image which is in the area selection window.
  1067.  
  1068.                 -23-            DOS ColorView 2.1
  1069.  
  1070.         APPENDIX A - Trademarks and Acknowledgments
  1071.  
  1072. ColorView is based in part on the work of the Independent JPEG Group.
  1073. The Independent JPEG Group disclaims all warranty and/or liability claims.
  1074.  
  1075. GIF files:
  1076. The Graphics Interchange Format (c) is the Copyright property of
  1077. CompuServe Incorporated.
  1078. GIF(sm) is a Service Mark property of CompuServe Incorporated.
  1079. For further information, please contact:
  1080. CompuServe Incorporated
  1081. Graphics Technology Department
  1082. 5000 Arlington Center Boulevard
  1083. Columbus, Ohio    43220
  1084. U. S. A.
  1085.  
  1086. Microsoft and MS-DOS are registered trademarks and Windows is a
  1087. trademark of Microsoft Corporation.
  1088.  
  1089. Intel is a registered trademark and 386 is a trademark of Intel Corporation.
  1090.  
  1091. ColorView and Millennium Technologies Corporation are trademarks of
  1092. Millennium Technologies Corporation.
  1093.